\section{strsplt --- Split a string}
\label{fn:strsplt}
\index{strsplt()}
\index{split a string}
\index{strings!splitting}
\index{elements of a string}
\begin{rail}
Strsplt : 'strsplt' '(' String ')' ;
\end{rail}

\verb+strsplt+ takes a character string as input, and returns a row
matrix that contains a single character string as each element. You
will get an error if the argument is not a string. String matricies
are not allowed as input to \verb+strsplt+. The
resulting matrix has as many columns as the  argument had
characters. 


\paragraph{Example}
\index{example of strsplt()}
\index{strsplt()!example}
\begin{verbatim}
> string1 = "a string"
a string
> StringMatrix = strsplt(string1)
 StringMatrix =
a     s  t  r  i  n  g  
> show(StringMatrix)
   name:      StringMatrix  
   class:     string        
   type:      string        
     nr:      1             
     nc:      8             
> strsplt("")
        []
> show( strsplt(""))
   name:      NULL    
   class:     string  
   type:      string  
     nr:      0       
     nc:      0       
> strsplt(25.5 + 4j)
rlab: strsplt, NULL, wrong type of arg to built-in should be: STRING
> strsplt("25.5 + 4j")
2  5  .  5     +     4  j 
\end{verbatim}

\newpage


